home *** CD-ROM | disk | FTP | other *** search
/ Aminet 47 / Aminet 47 (2002)(GTI - Schatztruhe)[Feb 2002].iso / Aminet / misc / math / acalc.lha / acalc.doc < prev    next >
Text File  |  2001-11-24  |  14KB  |  338 lines
  1.  
  2.  
  3.                           ACalc - Manuel de référence
  4.  
  5.  
  6.  
  7.  
  8.  
  9. AboutThisDoc
  10.  
  11.           Ce manuel décrit la version 1.50 de l'utilitaire ACalc. Ce programme
  12.   est Copyright ©2001 par Denis GOUNELLE.  Toute  utilisation  commerciale  ou
  13.   vente sans autorisation écrite de son auteur est strictement interdite. Vous
  14.   pouvez copier et diffuser ce programme aux conditions suivantes :
  15.  
  16.         - l'ensemble des fichiers doit être fourni
  17.         - aucun fichier ne doit avoir été modifié
  18.         - vous ne devez pas demander plus de 40FF pour cela
  19.  
  20.           Malgré de nombreux tests, je ne peux garantir que ACalc ne  contient
  21.   aucune erreur. VOUS UTILISEZ CE PROGRAMME A VOS RISQUES  ET  PERILS.  Je  ne
  22.   pourrai en aucun cas être tenu pour responsable de tout dommage,  direct  ou
  23.   indirect, résultant de l'utilisation de ACalc.
  24.  
  25. Introduction
  26.  
  27.           ACalc est une calculatrice fonctionnant en  mode  virgule  flottante
  28.   (IEEE double précision) et en mode basé (décimal  ou  hexadécimal),  capable
  29.   d'apparaitre sur n'importe quel écran. Sous système 2.04  ou  supérieur,  le
  30.   programme s'installe automatiquement en  tant  que  "commodité",  mais  peut
  31.   également être utilisé autrement.
  32.  
  33.           Vos critiques et suggestions sur ce programme  seront  toujours  les
  34.   bienvenues. N'hésitez pas à m'écrire, à l'adresse suivante :
  35.  
  36.                                M. GOUNELLE Denis
  37.                               27, rue Jules GUESDE
  38.                             45400 FLEURY-LES-AUBRAIS
  39.                                      FRANCE
  40.  
  41.                            denis.gounelle@wanadoo.fr
  42.                http://perso.wanadoo.fr/denis.gounelle/index.html
  43.  
  44.   Merci à Stéphane "SADA" Anquetil pour l'icône.
  45.  
  46. Installation
  47.  
  48.           Utilisez le script d'installation inclus dans l'archive.
  49.  
  50.           ACalc a besoin de la bibliothèque "mathieeedoubbas.library", qui est
  51.   fournie par Commodore sur les disquettes système. Sous système  1.3,  copiez
  52.   simplement le programme dans  un  répertoire  situé  dans  votre  chemin  de
  53.   recherche (par exemple "C:").
  54.  
  55.           Sous système 2.04 et plus, vous voudrez sans doute  installer  ACalc
  56.   en "commodité", et donc le copier dans le répertoire  "SYS:WBStartup",  pour
  57.   qu'il soit actif dès le démarrage.
  58.  
  59.           Pour utiliser la conversion Euros, vous devez  définir  le  taux  de
  60.   conversion  entre  votre  monnaie  locale  et  l'Euro   dans   la   variable
  61.   d'environnement "EURO". Pour le Franc Français par exemple, le taux  est  de
  62.   "6.55957".
  63.  
  64. Appel_depuis_le_CLI
  65.  
  66.           ACalc se détache automatiquement du CLI. Les arguments acceptés sont
  67.   les suivants :
  68.  
  69.       CX_PRIORITY n (ignoré sous système 1.3)
  70.           Fixe la priorité pour l'installation en "commodité".
  71.  
  72.       CX_HOTKEY touche (ignoré sous système 1.3)
  73.           Indique la combinaison de touches  permettant  d'appeler  ACalc,
  74.           quand il est installé en "commodité". La combinaison par  défaut
  75.           est "ctrl esc".
  76.  
  77.       CX_POPUP
  78.           Ouvre la fenêtre au démarrage.
  79.  
  80.       NOCOMM (ignoré sous système 1.3)
  81.           Demande à ACalc de ne pas s'installer en  "commodité",  mais  de
  82.           fonctionner comme un programme normal. Le programme se terminera
  83.           donc dès que vous cliquerez sur le gadget de fermeture.
  84.  
  85.       SAVEVAR
  86.           Demande à ACalc de sauvegarder le résultat  dans  une  variable,
  87.           plutôt que d'utiliser le Clipboard.  La  variable  utilisée  est
  88.           "ACalcResult".
  89.  
  90.       REXXPORT
  91.           Nom du port AREXX. La valeur par défaut est "ACalc".
  92.  
  93.       PUBSCREEN
  94.           Nom de l'écran public à  utiliser.  Par  défaut,  ACalc  utilise
  95.           l'écran au premier plan.
  96.  
  97.       LOCALECUR
  98.           Nom ou symbole de  votre  monnaie  locale,  pour  la  touche  de
  99.           conversion Euro. Notez que  ACalc  n'affichera  pas  plus  de  3
  100.           caractères dans la touche. La valeur par défaut est "FRF".
  101.  
  102. Appel_depuis_le_Workbench
  103.  
  104.           Vous pouvez indiquer les arguments suivants,  dans  le  champ  "TOOL
  105.   TYPES" de l'icône de ACalc :
  106.  
  107.       CX_PRIORITY=n (ignoré sous système 1.3)
  108.           Fixe la priorité pour l'installation en "commodité".
  109.  
  110.       CX_HOTKEY=touche (ignoré sous système 1.3)
  111.           Indique la combinaison de touches  permettant  d'appeler  ACalc,
  112.           quand il est installé en "commodité". La combinaison par  défaut
  113.           est "ctrl esc".
  114.  
  115.       CX_POPUP
  116.           Ouvre la fenêtre au démarrage.
  117.  
  118.       NOCOMM (ignoré sous système 1.3)
  119.           Demande à ACalc de ne pas s'installer en  "commodité",  mais  de
  120.           fonctionner comme un programme normal. Le programme se terminera
  121.           donc dès que vous cliquerez sur le gadget de fermeture.
  122.  
  123.       SAVEVAR
  124.           Demande à ACalc de sauvegarder le résultat  dans  une  variable,
  125.           plutôt que d'utiliser le Clipboard.  La  variable  utilisée  est
  126.           "ACalcResult".
  127.  
  128.       REXXPORT
  129.           Nom du port AREXX. La valeur par défaut est "ACalc".
  130.  
  131.       PUBSCREEN
  132.           Nom de l'écran public à  utiliser.  Par  défaut,  ACalc  utilise
  133.           l'écran au premier plan.
  134.  
  135.       LOCALECUR
  136.           Nom ou symbole de  votre  monnaie  locale,  pour  la  touche  de
  137.           conversion Euro. Notez que  ACalc  n'affichera  pas  plus  de  3
  138.           caractères dans la touche. La valeur par défaut est "FRF".
  139.  
  140. Utilisation_du_programme
  141.  
  142.           Au démarrage, ACalc ouvre sa fenêtre sur l'écran  au  premier  plan.
  143.   Cette fenêtre présente une zone d'affichage et un clavier de 36 touches.  La
  144.   plupart de ces touches sont évidentes d'emploi, aussi ce chapitre ne  décrit
  145.   que celles qui en ont besoin.
  146.  
  147.       Touche de mode (FLT,DEC,HEX)
  148.           ACalc possède trois modes de calculs : le mode virgule flottante
  149.           (FLT), le mode basé décimal (DEC) et le  mode  basé  hexadécimal
  150.           (HEX). Dans ces deux derniers modes, les calculs  se  font  avec
  151.           des entiers non signés de 32 bits. Suivant le mode  sélectionné,
  152.           certaines touches seront désactivées.
  153.  
  154.       EUR
  155.           En mode FLT,  déclenche  une  conversion  depuis  votre  monnaie
  156.           locale en Euros.
  157.  
  158.           Note: le taux de conversion doit être indiqué dans  la  variable
  159.           d'environnement EURO, sinon un  message  d'erreur  sera  affiché
  160.           (voir chapitre "Installation").
  161.  
  162.       FRF (ou autre)
  163.           En mode FLT, déclenche  une  conversion  de  l'Euro  vers  votre
  164.           monnaie locale.
  165.  
  166.           Note: le taux de conversion doit être indiqué dans  la  variable
  167.           d'environnement EURO, sinon un  message  d'erreur  sera  affiché
  168.           (voir chapitre "Installation").
  169.  
  170.           Note: le texte de la touche est "FRF" par défaut, mais peut être
  171.           changé avec l'argument LOCALECUR.
  172.  
  173.       d
  174.           En mode HEX, permet d'indiquer que le nombre  qui  suit  est  un
  175.           nombre décimal.
  176.  
  177.       h
  178.           En mode DEC, permet d'indiquer que le nombre  qui  suit  est  un
  179.           nombre hexadécimal.
  180.  
  181.       STO
  182.           Cette  touche  n'est  utilisable  que  lorsqu'un  résultat   est
  183.           affiché. Elle permet de stocker ce  résultat  dans  une  des  10
  184.           mémoires disponibles.  Après  avoir  cliqué  sur  cette  touche,
  185.           cliquez sur un des chiffres  de  0  à  9  pour  sélectionner  la
  186.           mémoire à utiliser.
  187.           Les mémoires sont initialisées à zéro au démarrage du programme.
  188.           Si ACalc est installé en "commodité", leur contenu est  conservé
  189.           entre deux appels du programme.
  190.  
  191.       RCL
  192.           Rappelle le contenu d'une mémoire. Après avoir cliqué sur  cette
  193.           touche, cliquez sur un des chiffres de 0 à 9  pour  sélectionner
  194.           la mémoire à utiliser.
  195.  
  196.       BS
  197.           Efface le dernier  caractère  de  l'expression  ou  du  résultat
  198.           affiché.
  199.  
  200.       =
  201.           Cette touche  lance  le  calcul  de  l'expression  affichée,  et
  202.           affiche son résultat ou un message d'erreur. Dans les deux  cas,
  203.           vous pouvez rappeler l'expression  en  appuyant  sur  le  bouton
  204.           droit de la souris.
  205.           Le résultat  peut  être  ré-utilisé  immédiatemment  :  si  vous
  206.           cliquez sur un opérateur, ACalc supposera que le résultat est la
  207.           première opérande. Sinon, le  résultat  sera  effacé  car  ACalc
  208.           supposera que vous voulez calculer une nouvelle expression.
  209.  
  210.           ACalc sauvegarde automatiquement le dernier résultat calculé dans le
  211.   Clipboard. Ceci vous permet de récupérer ce  résultat  dans  n'importe  quel
  212.   programme qui utilise également le Clipboard (par exemple  votre  traitement
  213.   de texte ou, sous système 2.0, la fenêtre Shell si  le  programme  "conclip"
  214.   est actif). Le fichier "clipboard.device" doit se trouver dans le répertoire
  215.   "DEVS:" pour que cette possibilité fonctionne.
  216.           Si  vous  préférez  sauvegarder  ce  résultat  dans   une   variable
  217.   d'environnement, plutôt que dans le Clipboard, il vous suffit  d'appeler  le
  218.   programme avec l'argument SAVEVAR  (voir  chapitres  Appel_depuis_le_CLI  et
  219.   Appel_depuis_le_Workbench).
  220.  
  221. Utilisation_avec_le_clavier
  222.  
  223.           ACalc peut être également utilisé avec le clavier de votre Amiga, et
  224.   cela de deux façons. La première consiste à cliquer sur la zone d'affichage,
  225.   et à éditer l'expression comme dans n'importe  quel  gadget  de  chaine.  La
  226.   seconde consiste simplement à appuyer sur les touches du  clavier  de  votre
  227.   Amiga, sans avoir au préalable activé le gadget de chaine. Dans ce cas, vous
  228.   disposez d'une possibilité supplémentaire : fermer la  fenêtre  en  appuyant
  229.   sur la touche ESCAPE.
  230.           Notez   cependant   que   certains   opérateurs   sont    transcrits
  231.   différemments par rapport au libellé des touches : ainsi l'opérateur NOT est
  232.   transcrit '~' (tilde). Si vous utilisez ACalc depuis  le  clavier,  il  vous
  233.   faudra donc taper '~' et non 'N', 'O' puis 'T'. Cette dernière forme ne sera
  234.   pas reconnue. Voici les caractères correspondant aux opérateurs :
  235.  
  236.           mode                            touche TAB
  237.           NOT                             ~
  238.           AND                             &
  239.           OR                              |
  240.           SHL                             <
  241.           SHR                             >
  242.           RCL                             M (suivit du numéro de mémoire)
  243.           BS                              touche BACKSPACE
  244.           conversion en Euros             d (en mode FLT)
  245.           conversion en monnaie locale    h (en mode FLT)
  246.  
  247.   Les touches STO et CLR n'ont pas d'équivalent clavier.
  248.  
  249. Port_AREXX
  250.  
  251.           ACalc dispose d'un port AREXX, dont le nom peut  être  indiqué  avec
  252.   l'argument REXXPORT. Toute chaine envoyée sur ce port sera prise  en  compte
  253.   de la même façon que si les caractères correspondants avaient été  tapés  au
  254.   clavier. Ceci veut dire entre autres que,  pour  provoquer  le  calcul  d'un
  255.   résultat, la chaine doit se terminer par un caractère "=". Le  résultat  est
  256.   alors disponible dans la variable  standard  RESULT.  Voici  un  exemple  de
  257.   script :
  258.  
  259.           /* AREXX */
  260.  
  261.           OPTIONS RESULTS
  262.           ADDRESS "ACalc"
  263.           "35/7.2635="
  264.           valeur = RESULT
  265.           SAY valeur
  266.  
  267.           Comme il est possible de faire des calculs directement  avec  AREXX,
  268.   le principal intérêt du port AREXX de  ACalc  est  de  pouvoir  utiliser  la
  269.   conversion Euro :
  270.  
  271.           /* AREXX */
  272.  
  273.           OPTIONS RESULTS
  274.           PARSE UPPER ARG montant
  275.           ADDRESS "ACalc"
  276.           /* conversion de la monnaie locale en Euros */
  277.           montant || "d"
  278.           valeur = RESULT
  279.           SAY "Montant en Euros:" valeur
  280.           /* conversion de l'Euro en monnaie locale */
  281.           montant || "h"
  282.           valeur = RESULT
  283.           SAY montant "Euros font:" valeur
  284.  
  285. Historique
  286.  
  287.   v1.00   15-Avr-93, 19904 octets
  288.           o Première version diffusée.
  289.  
  290.   v1.01   26-May-93, 20140 octets
  291.           o Erreur corrigée: l'affichage n'était pas correct si la  police  de
  292.             l'écran était proportionnelle (force désormais la topaz 8 dans  ce
  293.             cas).
  294.  
  295.   v1.02   29-May-93, 20148 octets
  296.           o Réagit à la commande "Montrer" du  programme  "Exchange"  (gestion
  297.             des commodités)
  298.  
  299.   v1.10   07-Jun-93, 21012 octets
  300.           o Essaye d'ouvrir la fenêtre sous le pointeur souris.
  301.           o Gestion des  polices  de  caractères  améliorée  :  est  désormais
  302.             capable de récupérer la police texte par défaut, et s'adapte à  la
  303.             police de l'écran par défaut pour le titre de  la  fenêtre  et  le
  304.             gadget de chaine.
  305.           o Si ACalc est installé en commodité, le  lancer  une  seconde  fois
  306.             fait apparaitre la fenêtre au lieu de terminer le programme.
  307.  
  308.   v1.20   29-Jun-93, 20924 octets
  309.           o Gestion des gadgets modifiés pour  que  l'activation/désactivation
  310.             en fonction du mode soit plus rapide (était beaucoup trop lent sur
  311.             un A500/A2000)
  312.  
  313.   v1.21   12-Sep-93, 20864 octets
  314.           o Utilise la nouvelle version de la fonction GetDefaultTextFont()
  315.  
  316.   v1.30   29-Oct-93, 21012 octets (Fish #942)
  317.           o Reçoit et prend en compte les  messages  du  programme  "Exchange"
  318.             même quand la fenêtre est ouverte
  319.           o Si on réveille le programme une seconde fois, la fenêtre vient  se
  320.             placer au premier plan
  321.           o Se positionne correctement sous la souris, même si l'écran courant
  322.             est plus grand que la taille d'affichage  (prend  les  coordonnées
  323.             dans la structure Screen au lieu de la structure IntuitionBase)
  324.  
  325.   v1.31   30-Dec-93, 20148 octets
  326.           o Ajout de l'argument CX_POPUP
  327.           o Compilé avec le SAS/C 6.50
  328.  
  329.   v1.40   02-Sep-01, 21680 octets
  330.           o Ajout de la conversion en Euros
  331.           o Compilé avec le SAS/C 6.58
  332.  
  333.   v1.50   11-Nov-01, 23304 octets
  334.           o Ajout de l'arrondi sur la conversion en Euros
  335.           o Ajout du port AREXX
  336.           o Ajout de l'argument PUBSCREEN
  337.           o Ajout d'un script d'installation
  338.